The objective of this utility is to re-arrange the directory. You also have the option of changing the load address of program files.
You'll be prompted for a disk, and a directory will appear on the screen. This utility will display all files, even the deleted ones. Move the cursor up and down using the cursor keys, the + and - keys to move one page up and down respectively, and HOME to go to the top of the directory. Now you're ready to edit the directory.
PLEASE NOTE: Except for the load address change command, no changes will be permanent until you press F1 to rewrite the directory. If you mess things up, press ESC to back out.
To move a file manually, move the cursor to the file, press RETURN or SPACE. Using the cursor keys, move the file to the desired position and then press RETURN or SPACE again. Now you're ready to move another file or do something else.
Pressing S will sort the files alphabetically. All deleted files will be moved to the end of the directory. If you want to use the sort feature, use it before moving files manually. The sort feature will alphabetize the directory regardless of which order the files was originally in.
C will compress the directory. All deleted files will be removed from the directory. If your disk contains many deleted files, compressing the directory will increase the overall performance. Furthermore, all new files saved to the disk will be tacked onto the end of the directory. With deleted files in the directory, new files will be saved at the first available directory position, which might be right in the middle. This might be undesirable. PLEASE NOTE: If you rewrite a compressed directory, all the removed files will be lost forever. They can NOT be revived by the unscratch utility.
L will lock or unlock a file. If it was unlocked it will be locked and vice versa. Locking a file will protect it from being scratched. However, it will NOT be protected against formatting of the disk. A locked file appears with a < -sign behind the file type. Deleted files cannot be locked.
T will change the file type of a file. Repeated presses will rotate the file types around. Keep pressing T until the desired file type identifier is shown. You can change the file type to DEL, but this will NOT erase the file from the disk. A DEL file (without a preceding asterisk) is a completely legitimate file type which can be read as any SEQ file. A DEL file cannot be copied using a file copier because the DOS won't allow the creation of a DEL file. Any attempt of doing so will result in a SEQ file being created. You cannot change the file type of a deleted file (DEL file with asterisk). To do that, you must unscratch the file first.
You can change the load address of a program (PRG) file by pressing A. All programs have two bytes at the beginning of it which tells from where in the computer's memory it was saved. This address is important in many cases. The BLOAD command will load the file to the address specified in the file, if you don't specify otherwise by using the P option. The familiar LOAD "file",8,1 from the 64 mode loads a file to the address in the file; normally the address from where it was originally saved. THE SERVANT will read the load address of the file and display it in decimal and hexadecimal notation. A cursor appears, and you may enter a new address for the file. On default, a decimal address is required, but you may enter a hexadecimal value if you put a dollar sign in front of it. If you don't wish to change the address, just press the ESC key. If you do enter a new address, it will be displayed in decimal and hexadecimal, and you'll be asked if it's OK to proceed. If you answer Y for yes, the new address will be written back to the disk. Otherwise, you'll get another chance to re-enter the address or exit.
N will let you change the name of a file. A window appears with the current name being displayed and the cursor flashing waiting for you to enter a new name. If you enter a name of an existing file you will be warned about this. You may want to re-enter the file name or ignore the warning and willfully use a duplicate file name. This is not good practice though. If a file name appears more than once in the directory, only the first one can be OPENed or LOADed. On the other hand, scratching the file will scratch all files with identical names.
Press F1 to save the modified directory back to disk if desired. You'll be asked if it's OK to do it. If not, you'll return to the directory display.
